package com.smart.community.region.service;

import java.util.List;
import java.util.Map;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.smart.community.region.dto.PropertyHouseTypeQueryDTO;
import com.smart.community.region.entity.PropertyHouseType;

/**
 * 物业公司户型表服务接口
 * 
 * @author Wu.Liang
 * @version 1.0.0
 * @since 2025-01-30
 */
public interface IPropertyHouseTypeService extends IService<PropertyHouseType> {

    /**
     * 根据物业公司ID查询户型列表
     * 
     * @param propertyCompanyId 物业公司ID
     * @return 户型列表
     * @throws Exception 统一异常
     */
    List<PropertyHouseType> getByPropertyCompanyId(Long propertyCompanyId) throws Exception;

    /**
     * 根据物业公司ID列表查询户型列表
     * 
     * @param propertyCompanyIds 物业公司ID列表
     * @return 按物业公司分组的户型列表
     * @throws Exception 统一异常
     */
    Map<Long, List<PropertyHouseType>> getByPropertyCompanyIds(List<Long> propertyCompanyIds) throws Exception;

    /**
     * 分页查询户型列表
     * 
     * @param queryDTO 查询条件
     * @return 分页结果
     * @throws Exception 统一异常
     */
    IPage<PropertyHouseType> getPage(PropertyHouseTypeQueryDTO queryDTO) throws Exception;

    /**
     * 创建户型
     * 
     * @param houseType 户型信息
     * @return 是否成功
     * @throws Exception 统一异常
     */
    boolean createHouseType(PropertyHouseType houseType) throws Exception;

    /**
     * 批量创建户型（支持多物业公司）
     * 
     * @param houseType 户型信息
     * @param propertyCompanyIds 物业公司ID列表
     * @return 是否成功
     * @throws Exception 统一异常
     */
    boolean createHouseTypeForCompanies(PropertyHouseType houseType, List<Long> propertyCompanyIds) throws Exception;

    /**
     * 更新户型
     * 
     * @param houseType 户型信息
     * @return 是否成功
     * @throws Exception 统一异常
     */
    boolean updateHouseType(PropertyHouseType houseType) throws Exception;

    /**
     * 删除户型
     * 
     * @param id 户型ID
     * @return 是否成功
     * @throws Exception 统一异常
     */
    boolean deleteHouseType(Long id) throws Exception;

    /**
     * 批量删除户型
     * 
     * @param ids 户型ID列表
     * @return 是否成功
     * @throws Exception 统一异常
     */
    boolean deleteBatchHouseTypes(List<Long> ids) throws Exception;

    /**
     * 更新户型状态
     * 
     * @param id 户型ID
     * @param status 状态
     * @return 是否成功
     * @throws Exception 统一异常
     */
    boolean updateStatus(Long id, Integer status) throws Exception;

    /**
     * 检查户型名称是否已存在
     * 
     * @param houseTypeName 户型名称
     * @param propertyCompanyId 物业公司ID
     * @param excludeId 排除的ID（用于更新时检查）
     * @return 是否存在
     * @throws Exception 统一异常
     */
    boolean checkHouseTypeNameExists(String houseTypeName, Long propertyCompanyId, Long excludeId) throws Exception;

    /**
     * 根据ID获取户型详情
     * 
     * @param id 户型ID
     * @return 户型详情
     * @throws Exception 统一异常
     */
    PropertyHouseType getHouseTypeById(Long id) throws Exception;
}
